OpenMLBB SDK Docs

OpenMLBB Endpoint

SDK call mapping, request requirements, and Python example.

Every card documents the SDK call from OpenMLBB and mirrors API path/query/body requirements.

GET Hero Recommended Builds

/openmlbb/academy/heroes/{hero_identifier}/builds

Open Only This

API Path: /api/academy/heroes/{hero_identifier}/builds

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • lane: Lane. Allowed values: exp, mid, roam, jungle, gold. from /api/academy/heroes/{hero_identifier}/lane
  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero build data:

  • records: Array of build entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • heroid: Hero ID.
          • hero_name: Hero name.
          • real_road: Lane assignment ID.
          • build: Array of recommended builds, each containing:
              • equipid: List of equipment IDs.
              • emblem: Emblem configuration:
                  • emblemid: Emblem ID.
                  • emblemname: Emblem name.
                  • emblemattr: Emblem attributes (e.g., '+10% Spell Vamp').
                  • attriicon: Emblem attribute icon URL.
              • battleskill: Battle spell configuration:
                  • battleskillid: Battle spell ID.
                  • skillname: Spell name (e.g., 'Retribution').
                  • skillshortdesc: Short description.
                  • skilldesc: Full description of spell effects.
                  • skillicon: Spell icon URL.
              • runeid: Rune ID.
              • new_rune_skill: Array of rune skill IDs.
              • build_pick_rate: Pick rate of the build.
              • build_win_rate: Win rate of the build.

This endpoint is useful for:

  • Displaying historical or community-recommended builds.
  • Providing backward compatibility for older integrations.
  • Should be replaced with newer endpoints for up-to-date build recommendations.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.hero_builds("miya", lane="exp", rank="all", size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
lane query string yes -
rank query string no all
size query integer no 20
index query integer no 1
lang query string no en